Skip to content

Update UDP docs for the new executor#260

Open
jachris wants to merge 5 commits intotopic/new-executorfrom
topic/port-udp
Open

Update UDP docs for the new executor#260
jachris wants to merge 5 commits intotopic/new-executorfrom
topic/port-udp

Conversation

@jachris
Copy link
Copy Markdown
Contributor

@jachris jachris commented Apr 15, 2026

🔍 Problem

  • The UDP docs still described the new-executor listener as from_udp.
  • The reference and guides no longer matched the renamed accept_udp surface.

🛠️ Solution

  • Rename the UDP listener docs from from_udp to accept_udp.
  • Update the operator reference, guides, and integration pages to use accept_udp.
  • Keep the companion to_udp references aligned with the code PR.

💬 Review

@github-actions github-actions Bot added reference Reference documentation integration Integration documentation site Site infrastructure labels Apr 15, 2026
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7b63122f4b

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment on lines +48 to +49
The name of the table to read from. This is mutually exclusive with `sql` and
`show`.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Fix conflicting table/show constraints in from_mysql docs

The table parameter is documented as mutually exclusive with show here, but the same page later defines show="columns" as requiring table and even provides that example. This contradiction makes the operator contract ambiguous for users trying to inspect column metadata and can lead to incorrect query construction. Please align the parameter rules so the show="columns" mode and table requirement are described consistently.

Useful? React with 👍 / 👎.

Comment on lines +362 to +365
- name: 'from_stdin'
description: 'Reads and parses events from standard input.'
example: 'from_stdin { read_json }'
path: 'reference/operators/from_stdin'
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Add from_tcp to the operators overview catalog

This change adds a dedicated from_tcp reference page, but the operators overview catalog was updated for other new operators while from_tcp was not added. As a result, users browsing /reference/operators won’t see from_tcp in the main list/cards, which makes the new operator much harder to discover from the primary reference entry point.

Useful? React with 👍 / 👎.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 15, 2026

📦 Preview  ·  View →  ·  🟢 Live

Auto-updates on push

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7a0828fffc

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".


</ReferenceCard>

<ReferenceCard title="to_udp" description="Sends one UDP datagram per input event." href="/reference/operators/to_udp">
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Place to_udp in the Events operator section

This new card is inserted in the bytes CardGrid (between save_udp and save_zmq) even though to_udp is documented as an event output operator (category: Outputs/Events in reference/operators/to_udp.mdx). On /reference/operators, users browse by section headings, so keeping to_udp under bytes makes it easy to miss and misclassifies its usage model. Move it to the Events section so discoverability and categorization match the operator contract.

Useful? React with 👍 / 👎.

@jachris jachris changed the title Add documentation for to_udp Update UDP docs for the new executor Apr 15, 2026
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: da3fb7dcc6

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

}
write_syslog
save_udp "1.2.3.4:514"
to_udp "1.2.3.4:514"
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Preserve syslog payload when switching to to_udp

This example now pipes write_syslog directly into to_udp without a message argument, but to_udp defaults to sending each input event as compact JSON when message is omitted. In this specific pipeline, that changes the wire payload from a raw RFC 5424 syslog line to JSON-encoded output, so readers following the example will not actually emit the message format described below the snippet.

Useful? React with 👍 / 👎.

Rename the UDP event-operator references and move the operator\npage to accept_udp. This keeps the guides and reference index\naligned with the neo operator rename.
@github-actions github-actions Bot added the guide How-to guides label Apr 23, 2026
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 63be85229d

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment on lines 152 to 153
| `tcp` | <Op>load_tcp</Op> | `from "tcp://127.0.0.1:13245" { read_json }` |
| `udp` | <Op>load_udp</Op> | `from "udp://127.0.0.1:56789" { read_json }` |
| `zmq` | <Op>load_zmq</Op> | `from "zmq://127.0.0.1:56789" { read_json }` |
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Restore UDP scheme mapping in from URI table

Removing the udp row from the from URI-scheme table makes the reference internally inconsistent: other docs in this repo still instruct users to run from "udp://..." (for example, reference/operators/assert_throughput.mdx), so readers can no longer discover the documented UDP from path from the canonical scheme list. Either keep the UDP mapping here or update all remaining UDP-URI usage docs in the same change.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

guide How-to guides integration Integration documentation reference Reference documentation site Site infrastructure

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant